Technote 1111

Programmatic Mounting of AppleShare Volumes

ñ⁄éü ÇÕÇ∂ÇflÇ… AppleShare Clients 3.0 Å| 3.6.5 AppleShare Client 3.7 óvñÒ

DZÇà TECHNOTE Ç≈ÇÕÅAPBVolumeMount åƒÇ—èoǵÇégǡǃ AppleShare É{ÉäÉÖÅ[ÉÄÇÉ}ÉEÉìÉgÇ∑ÇÈï˚ñ@DžǬǢǃê‡ñæǵNjÇ∑ÅB

const   short   kASver_3_5      = 1;
const   short   kASver_3_6      = 2;
const   short   kASver_3_6_1    = 3;
const   short   kASver_3_6_2    = 4;
const   short   kASver_3_6_3    = 5;    // 3.6.3ÅA3.6.4ÅA3.6.5 Çä‹Çfi
const   short   kASver_3_7      = 6;    // 3.7.1 Çä‹Çfi
const   short   kASver_3_7_2    = 7;

short   ClientVersion(void)
{
    long    result;
    OSError theError = noErr;

    theError = Gestalt('afps',&result);
    if(!theError)
    {
        return(result & 0x0000ffff);
    }
    return 0;
}

struct AFPVolMountInfo {
    short       length;               /* ÉçÉPÅ[ÉVÉáÉìÉfÅ[É^ÇÃí∑Ç≥ (DZÇÃÉtÉBÅ[ÉãÉhǪÇÃLJÇÃÇä‹Çfi) */
    VolumeType  media;                /* ÉÅÉfÉBÉAÇÃÉ^ÉCÉv */
    short       flags;                /* ÉÅÉbÉZÅ[ÉWÅAçƒê⁄ë±Ç™Ç»Ç¢Ç©Ç«Ç§Ç©ÇéwíËÇ∑ÇÈÉrÉbÉg */
    SInt8       nbpInterval;          /* NBP Interval ÉpÉâÉÅÅ[É^ (IM2, p.322 ÇéQèΔ) */
    SInt8       nbpCount;             /* NBP Interval ÉpÉâÉÅÅ[É^ (IM2, p.322 ÇéQèΔ) */
    short       uamType;              /* ÉÜÅ[ÉUîFèÿï˚ñ@ */
    short       zoneNameOffset;       /* ç\ë¢ëÃÇÃêÊì™Ç©ÇÁ Zone Name Ç‹Ç≈Çà short Ç≈ê≥ÇÃÉIÉtÉZÉbÉg */
    short       serverNameOffset;     /* Pascal ï∂éöóÒ Server Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short       volNameOffset;        /* Pascal ï∂éöóÒ Volume Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short       userNameOffset;       /* Pascal ï∂éöóÒ User Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short       userPasswordOffset;   /* Pascal ï∂éöóÒ User Password Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short       volPasswordOffset;    /* Pascal ï∂éöóÒ Volume Password Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    char        AFPData[176];         /* â¬ïœí∑ÉfÅ[É^Ç™ë±Ç≠èÍçá */
};
typedef struct AFPVolMountInfo AFPVolMountInfo;

• TCP/IP ÇâÓǵÇΩÉ{ÉäÉÖÅ[ÉÄÇÃÉ}ÉEÉìÉg
• AppleShare Client ÇÃÅgÉçÉOÉCÉìÅhÇ®ÇÊÇ—ÅgÉ{ÉäÉÖÅ[ÉÄëIëÅhÉ_ÉCÉAÉçÉOÇégópÇ∑ÇÈÇΩÇflÇÃÉIÉvÉVÉáÉì
• PBVolumeMount Ç≈ÇÃÉJÉXÉ^ÉÄ UAM (User Authentication Module) ÇÃÉTÉ|Å[Ég

AFPXVolMountInfo ÇégÇ¡ÇΩ PBVolumeMount
éüÇÃíËã`Çå©ÇÍÇŒÅAAFPXVolMountInfo ç\ë¢ëÃÇ™ëOèqÇà AFPVolMountInfo ç\ë¢ëÃÇÃägí£Ç≈džÇÈDZÇΔÇ™Ç∑ÇÆÇ…ÇÌÇ©ÇËÇ‹Ç∑ÅB3 ǬÇÃêVǵǢÉtÉBÅ[ÉãÉhÇΔ 2 ǬÇÃêVǵǢÉtÉâÉOÉrÉbÉgÇégópÇ∑ÇÈÇΔÅAÉfÉxÉçÉbÉpÇÕ TCP/IP Ç‚ UAM ÇÉTÉ|Å[ÉgÇ∑ÇÈÇΩÇflÇ…ïKóvÇ»èÓïÒÇéwíËÇ≈Ç´ÇÈÇÊǧDžǻÇËÇ‹Ç∑ÅBLJÇøÇÎÇÒ 3.7 Client Ç≈ÇÕÅAà»ëOÇà AFPVolMountInfo ç\ë¢ëÃLJÉTÉ|Å[ÉgÇ≥ÇÍǃǢNjÇ∑ÅB

éüÇ…ÅAç≈êVÇà Files.h Ç…ä‹Ç‹ÇÍÇÈíËã`Çé¶ÇµÇ‹Ç∑ÅB

/* AFPXVolMountInfo ÇÕêVǵǢ AFP É{ÉäÉÖÅ[ÉÄÉ}ÉEÉìÉgèÓïÒÉåÉRÅ[ÉhÇ≈ÅA3.7 AppleShare Client ÇïKóvÇΔÇ∑ÇÈ */

struct AFPXVolMountInfo {
    short         length;                 /* ÉçÉPÅ[ÉVÉáÉìÉfÅ[É^ÇÃí∑Ç≥ (DZÇÃÉtÉBÅ[ÉãÉhǪÇÃLJÇÃÇä‹Çfi) */
    VolumeType    media;                  /* ÉÅÉfÉBÉAÇÃÉ^ÉCÉv */
    short         flags;                  /* ÉÅÉbÉZÅ[ÉWÅAçƒê⁄ë±Ç™Ç»Ç¢Ç©Ç«Ç§Ç©ÇéwíËÇ∑ÇÈÉrÉbÉg */
    SInt8         nbpInterval;            /* NBP Interval ÉpÉâÉÅÅ[É^ (IM2, p.322 ÇéQèΔ) */
    SInt8         nbpCount;               /* NBP Interval ÉpÉâÉÅÅ[É^ (IM2, p.322 ÇéQèΔ) */
    short         uamType;                /* ÉÜÅ[ÉUîFèÿï˚ñ@ÇÃÉ^ÉCÉv */
    short         zoneNameOffset;         /* ç\ë¢ëÃÇÃêÊì™Ç©ÇÁ Zone Name Ç‹Ç≈Çà short Ç≈ê≥ÇÃÉIÉtÉZÉbÉg */
    short         serverNameOffset;       /* Pascal ï∂éöóÒ Server Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short         volNameOffset;          /* Pascal ï∂éöóÒ Volume Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short         userNameOffset;         /* Pascal ï∂éöóÒ User Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short         userPasswordOffset;     /* Pascal ï∂éöóÒ User Password Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short         volPasswordOffset;      /* Pascal ï∂éöóÒ Volume Password Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short         extendedFlags;          /* ägí£Ç≥ÇÍÇΩÉtÉâÉOÉèÅ[Éh */
    short         uamNameOffset;          /* Pascal ï∂éöóÒ UAM Name Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    short         alternateAddressOffset; /* É^ÉOÉtÉHÅ[É}ÉbÉgÇà Alternate Addresses Ç‹Ç≈ÇÃÉIÉtÉZÉbÉg */
    char          AFPData[176];           /* â¬ïœí∑ÉfÅ[É^Ç™ë±Ç≠èÍçá */
};
typedef struct AFPXVolMountInfo AFPXVolMountInfo;

typedef AFPXVolMountInfo *              AFPXVolMountInfoPtr;

/* É{ÉäÉÖÅ[ÉÄÉ}ÉEÉìÉgÉtÉâÉO */

enum {
    volMountNoLoginMsgFlagBit   = 0,         /* VolumeMount Ç÷ÇÃì¸óÕ: ÉZÉbÉgÇ≥ÇÍǃǢÇÈèÍçáÅAÉtÉ@ÉCÉãÉVÉXÉeÉÄÇÕ */
    volMountNoLoginMsgFlagMask  = 0x0001,    /* ÉçÉOÉCÉìÉÅÉbÉZÅ[ÉWÉ_ÉCÉAÉçÉOÇï\é¶ÇµÇ»Ç¢ */
    volMountExtendedFlagsBit    = 7,         /* VolumeMount Ç÷ÇÃì¸óÕ: ÉZÉbÉgÇ≥ÇÍǃǢÇÈèÍçáÅAÉ}ÉEÉìÉgèÓïÒÇÕ */
    volMountExtendedFlagsMask   = 0x0080,    /* 3.7 AppleShare Client Ç…ëŒâûÇ∑ÇÈ AFPXVolMountInfo ÉåÉRÅ[Éh */
    volMountInteractBit         = 15,        /* VolumeMount Ç÷ÇÃì¸óÕ: ÉZÉbÉgÇ≥ÇÍǃǢÇÈèÍçáÅAÉtÉ@ÉCÉãÉVÉXÉeÉÄÇ™ */
    volMountInteractMask        = 0x8000,    /* É{ÉäÉÖÅ[ÉÄÇÉ}ÉEÉìÉgÇ∑ÇÈÇΩÇflÇ…ÉÜÅ[ÉUÇÃëÄçÏÇé¿çsÇ∑ÇÈDZÇΔÇ™ãñâ¬Ç≥ÇÍÇÈ */
    volMountChangedBit          = 14,        /* VoumeMount Ç©ÇÁÇÃèoóÕ: ÉZÉbÉgÇ≥ÇÍǃǢÇÈèÍçáÅAÉ{ÉäÉÖÅ[ÉÄÇÕÉ}ÉEÉìÉgÇ≥ÇÍǃǢÇΩÇ™ÅA */
    volMountChangedMask         = 0x4000,    /* É{ÉäÉÖÅ[ÉÄÇÃÉ}ÉEÉìÉgèÓïÒÉåÉRÅ[ÉhÇÕçXêVÇ≥ÇÍÇÈïKóvǙdžÇÈ */
    volMountFSReservedMask      = 0x00FF,    /* ÉrÉbÉg 0-7 ÇÕǪÇÍǺÇÍÇÃÉtÉ@ÉCÉãÉVÉXÉeÉÄÇ™ìΔé©Ç…égópÇ∑ÇÈÇΩÇflÇ…íËã`Ç≥ÇÍǃǢÇÈ */
    volMountSysReservedMask     = 0xFF00     /* ÉrÉbÉg 8-15ÇÕ Apple ÉVÉXÉeÉÄÇ™égópÇ∑ÇÈÇΩÇflÇ…ó\ñÒÇ≥ÇÍǃǢÇÈ */
};

enum {
    kAFPExtendedFlagsAlternateAddressMask = 1  /* AFPXVolMountInfo.extendedFlags ÇÃÉrÉbÉgÇ≈ÅAalternateAddressOffset Ç™égópÇ≥ÇÍǃǢÇÈDZÇΔÇà”ñ°Ç∑ÇÈ */
};

enum {    /* AFPTagData.fType ÉtÉBÅ[ÉãÉhÇ≈égópÇ∑ÇÈíËêî */
    kAFPTagTypeIP        = 0x01,
    kAFPTagTypeIPPort    = 0x02,
    kAFPTagTypeDDP       = 0x03    /* åªç›ÇÕñ¢égóp */
};



enum {    /* AFPTagData.fLength ÉtÉBÅ[ÉãÉhÇ≈égópÇ∑ÇÈíËêî */
    kAFPTagLengthIP        = 0x06,
    kAFPTagLengthIPPort    = 0x08,
    kAFPTagLengthDDP       = 0x06
};

struct AFPTagData {
    UInt8    fLength;     /* fLength ÉtÉBÅ[ÉãÉhÇä‹ÇflÇΩDZÇÃÉfÅ[É^É^ÉOÇÃí∑Ç≥ */
    UInt8    fType;
    UInt8    fData[1];    /* â¬ïœí∑ÉfÅ[É^ */
};
typedef struct AFPTagData AFPTagData;

struct AFPAlternateAddress {
    UInt8    fAddressCount;
    UInt8    fAddressList[1];    /* AFPTagData ÇÃé¿ç€Ç…â¬ïœí∑ÉpÉbÉNÇ≥ÇÍÇΩÉZÉbÉg */
};
typedef struct AFPAlternateAddress AFPAlternateAddress;

çXêVì˙: 1997 îN 10 åé 31 ì˙